1   /*
2    * Copyright (C) 2007 The Guava Authors
3    *
4    * Licensed under the Apache License, Version 2.0 (the "License");
5    * you may not use this file except in compliance with the License.
6    * You may obtain a copy of the License at
7    *
8    * http://www.apache.org/licenses/LICENSE-2.0
9    *
10   * Unless required by applicable law or agreed to in writing, software
11   * distributed under the License is distributed on an "AS IS" BASIS,
12   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13   * See the License for the specific language governing permissions and
14   * limitations under the License.
15   */
16  
17  package com.google.common.collect.testing;
18  
19  import com.google.common.annotations.GwtCompatible;
20  import com.google.common.collect.testing.SampleElements.Strings;
21  
22  import java.util.List;
23  
24  /**
25   * TODO: javadoc.
26   *
27   * @author Kevin Bourrillion
28   */
29  @GwtCompatible
30  public abstract class TestStringListGenerator
31      implements TestListGenerator<String> {
32    @Override
33    public SampleElements<String> samples() {
34      return new Strings();
35    }
36  
37    @Override
38    public List<String> create(Object... elements) {
39      String[] array = new String[elements.length];
40      int i = 0;
41      for (Object e : elements) {
42        array[i++] = (String) e;
43      }
44      return create(array);
45    }
46  
47    /**
48     * Creates a new collection containing the given elements; implement this
49     * method instead of {@link #create(Object...)}.
50     */
51    protected abstract List<String> create(String[] elements);
52  
53    @Override
54    public String[] createArray(int length) {
55      return new String[length];
56    }
57  
58    /** Returns the original element list, unchanged. */
59    @Override
60    public List<String> order(List<String> insertionOrder) {
61      return insertionOrder;
62    }
63  }